Motivation

I wanted to review the jekyll documentation but I found it difficult to read. The gif screencasts are helpful, but don't meet accessibility guidelines. They detract from learning due to the auto-play and looping, and are inconsistent with similar style screencasts formatted as video.

Implementation

I converted all jekyll/images/*.gif files to mp4 with:

ffmpeg -i filename.gif -movflags faststart -pix_fmt yuv420p -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" filename.mp4

retaining the same dimensions and quality while reducing file size. I chose to keep the width for all videos at 100% for consistency. This causes some slight stretching/blurring for videos on the rails add on page when on large screens. Some of the original gifs were only 640px wide out of ~740px full width.

Automated Tests

N/A

Manual Tests

I reviewed every affected markdown file to ensure nothing else inadvertently changed. I reviewed and verified every mp4.

Thank you

I appreciate your time on this project, thank you.